Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Functions

Manipulating Controls /

DeactivateControl

NEW WITH THE APPEARANCE MANAGER

Deactivates a control and any latent embedded controls.

pascal OSErr DeactivateControl (ControlHandle inControl);

inControl

On input, a handle to the control that you wish to deactivate. Passing a window's root control will deactivate all controls in that window.

function result

A result code; see "Result Codes".

DISCUSSION

The DeactivateControl function should be called instead of HiliteControl to deactivate a specified control and its latent embedded controls. For a discussion of latency, see "Manipulating Controls".

You can use DeactivateControl to deactivate all controls in a window by passing the window's root control in the inControl parameter.

If a control definition function supports activate events, it will receive a kControlMsgActivate message before redrawing itself in its inactive state.

SEE ALSO

ActivateControl.

"Embedding Controls".

"Appearance Manager Gestalt Selector Constants".